home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / a_man / cat1 / snetd.z / snetd
Encoding:
Text File  |  2001-04-17  |  20.4 KB  |  463 lines
  1.  
  2.  
  3.  
  4. SSSSNNNNEEEETTTTDDDD((((1111MMMM))))                                                            SSSSNNNNEEEETTTTDDDD((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      snetd - DLPI network daemon
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ssssnnnneeeettttdddd [----nnnntttt] [ _c_o_n_f_i_g__f_i_l_e |||| ---- ]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      _s_n_e_t_d configures a _S_T_R_E_A_M_S network from a specification given in a
  16.      configuration file whose format is described in the _C_o_n_f_i_g_u_r_a_t_i_o_n
  17.      section.
  18.  
  19.      By default the configuration is taken from the file
  20.      /_e_t_c/_c_o_n_f_i_g/_s_n_e_t_d._o_p_t_i_o_n_s. An alternative file may be specified as a
  21.      command line argument (_c_o_n_f_i_g__f_i_l_e).  The special filename '----' is taken
  22.      to mean the standard input.
  23.  
  24.      Upon system startup, if the state of the _s_n_e_t_d daemon is _o_n, the daemon
  25.      is started by /etc/init.d/network. You may use _c_h_k_c_o_n_f_i_g(1M) to check the
  26.      state of the daemon or to change its state.
  27.  
  28.      The ----tttt option may be used to debug a configuration file.  It produces
  29.      trace information indicating the sequence of opens, links, etc. performed
  30.      by _s_n_e_t_d to create the _S_T_R_E_A_M_S architecture defined by the configuration.
  31.  
  32.      The ----nnnn option, which also implies ----tttt ,,,, inhibits the actual building of
  33.      the _S_T_R_E_A_M_S network.
  34.  
  35. CCCCOOOONNNNFFFFIIIIGGGGUUUURRRRAAAATTTTIIIIOOOONNNN
  36.      This section describes the configuration of the _S_T_R_E_A_M_S network
  37.      constructed by _s_n_e_t_d.
  38.  
  39.      The file is in two sections, mmmmoooodddduuuulllleeee and ssssttttrrrreeeeaaaammmmssss , separated by a line
  40.      consisting of the character sequence '%%'.  Blank lines may be used
  41.      freely throughout the file, and a _t_o_k_e_n (see below) beginning with an
  42.      unquoted '####' (hash) denotes a comment which lasts till the end of the
  43.      line.  In addition, a backslash (\\\\) immediately preceding the end of a
  44.      line results in the newline being treated as whitespace (except at the
  45.      end of comment lines).
  46.  
  47.      _T_o_k_e_n_s consist either of
  48.  
  49.      a)   a single occurrence of the special characters { '=', '{', ',', '}' }
  50.  
  51.      (NNNNooootttteeee::::  '=' is _n_o_t a special character within the brace-enclosed argument
  52.      list of a control message; ',' is _o_n_l_y a special character in this
  53.      position.)
  54.  
  55.      b)   strings of arbitrary characters enclosed in single or double quotes
  56.           (''' or '"'), but not containing a newline - each quoting character
  57.           quotes the other, for example, "foo 'bar'" or '"foo" bar'
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SSSSNNNNEEEETTTTDDDD((((1111MMMM))))                                                            SSSSNNNNEEEETTTTDDDD((((1111MMMM))))
  71.  
  72.  
  73.  
  74.      (Newlines occurring within quoted strings will silently terminate the
  75.      string.)
  76.  
  77.      c)   sequences of non-whitespace characters not including any of the
  78.           special characters or quotes
  79.  
  80.      All strings are case-sensitive, and are silently truncated to 200
  81.      characters.
  82.  
  83.      The mmmmoooodddduuuulllleeeessss section describes the individual modules and drivers from
  84.      which the _S_T_R_E_A_M_S network configuration will be built.
  85.  
  86.      tcp    dc    /dev/tcp
  87.      arp    m     arp
  88.      x25    dc    /dev/x25
  89.      lapb0  dc    /dev/lapb0
  90.  
  91.      Each line (such as the examples above) consists of three tokens
  92.      (separated by whitespace or tabs) as follows.
  93.  
  94.      The mmmmoooodddduuuulllleeee iiiiddddeeeennnnttttiiiiffffiiiieeeerrrr is the name by which the module or driver will be
  95.      known in the streams section (see below).
  96.  
  97.      The mmmmoooodddduuuulllleeee ttttyyyyppppeeee is a sequence of character flags describing the module or
  98.      driver.  The flag 'dddd' describes a _S_T_R_E_A_M_S _d_r_i_v_e_r , whereas 'mmmm' describes
  99.      a _m_o_d_u_l_e. The 'cccc' flag specifies a driver to be _c_l_o_n_e_a_b_l_e. (See the
  100.      _S_T_R_E_A_M_S _P_r_o_g_r_a_m_m_e_r'_s _G_u_i_d_e for a detailed description of modules and
  101.      drivers.)
  102.  
  103.      The mmmmoooodddduuuulllleeee nnnnaaaammmmeeee is the _c_h_a_r_a_c_t_e_r _d_e_v_i_c_e _n_a_m_e for a driver, or the
  104.      _p_u_s_h_a_b_l_e _m_o_d_u_l_e _n_a_m_e for a module.
  105.  
  106.      The ssssttttrrrreeeeaaaammmmssss section describes the architecture of the network in terms of
  107.      how the previously defined modules and drivers are to be combined (by
  108.      means of the appropriate PUSHes and LINKs) into streams.  Multiplexing
  109.      and cloning are handled automatically by the _s_n_e_t_d(1M) utility.
  110.  
  111.      ip    arp      IP_NET=89.0.0.3
  112.      x25   lapb0    SHELL="x25tune -P -s A def.dte.x25" \
  113.                     X25_SET_SNID={A, LC_LAPBDTE, , }
  114.  
  115.      Lines in this section (such as the above examples) are of the following
  116.      form.
  117.  
  118.      The first two tokens on a line are nnnnaaaammmmeeeessss (_m_o_d_u_l_e _i_d_e_n_t_i_f_i_e_r_s as defined
  119.      in the previous section) of drivers or modules which are to form the
  120.      uuuuppppssssttttrrrreeeeaaaammmm and ddddoooowwwwnnnnssssttttrrrreeeeaaaammmm components respectively of a _S_T_R_E_A_M_S link.
  121.  
  122.      Each link performed between token 1 and token 2 generates a _m_u_x__i_d
  123.      (multiplexing identifier) which is associated with that link.  It is
  124.      possible to override the generated link by replacing token 2 with an
  125.      explicit mux_id, for example:
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. SSSSNNNNEEEETTTTDDDD((((1111MMMM))))                                                            SSSSNNNNEEEETTTTDDDD((((1111MMMM))))
  137.  
  138.  
  139.  
  140.      lapb0    1     LL_SET_SNID=A \
  141.                     SHELL="lltune -P -p lapb -s B -d /dev/lapb0 def.lapb"
  142.  
  143.      This sets the _m_u_x__i_d associated with the link to 1111 ....
  144.  
  145.      These names may be _q_u_a_l_i_f_i_e_d by a suffix consisting of a colon (::::) and a
  146.      number (for example _a_r_p:_1) to signify a particular _i_n_s_t_a_n_t_i_a_t_i_o_n of a
  147.      module.  (An uninstantiated _n_a_m_e is an abbreviation for _n_a_m_e:0.)  Each
  148.      instantiation of a module can be thought of as a separate _b_l_o_c_k in a
  149.      _S_T_R_E_A_M_S Architecture diagram.  Separate instantiations would be
  150.      appropriate for, say, a module pushed above more than one driver, but not
  151.      for a cloneable multiplexed driver.
  152.  
  153.      Instantiations are used in the 'streams' section only, to instantiate
  154.      modules defined in the 'modules' section.  The following networking
  155.      example would run IP over two distinct networks:
  156.  
  157.      ip       dc     /dev/ip
  158.      arp      m      arp
  159.      ethr0    dc     /dev/ethr0
  160.      ethr1    dc     /dev/ethr1
  161.  
  162.      %%
  163.  
  164.      ip      arp:0   IP_NET=89.0.0.1
  165.      arp:0   ethr0   ARP_TYPE
  166.  
  167.      ip      arp:1   IP_NET=89.0.0.2
  168.      arp:1   ethr1   ARP_TYPE
  169.  
  170.      The remainder of each line consists of a (possibly null) sequence of
  171.      _c_o_n_t_r_o_l _a_c_t_i_o_n_s to be performed on completion of the link in the order
  172.      specified.
  173.  
  174.      Each control action is of the form _f_u_n_c_t_i_o_n = _a_r_g_u_m_e_n_t-_l_i_s_t, where the
  175.      _a_r_g_u_m_e_n_t-_l_i_s_t is either a single string argument or a comma-separated
  176.      list enclosed in braces ({{{{ and }}}}).  Control actions requiring no
  177.      arguments may consist simply of the _f_u_n_c_t_i_o_n component.  Arguments
  178.      containing whitespace or any of the special characters listed above must
  179.      be quoted.
  180.  
  181.      The following ccccoooonnnnttttrrrroooollll aaaaccccttttiiiioooonnnnssss are currently defined:
  182.  
  183.      IIIIPPPP____NNNNEEEETTTT={_i_n_t_e_r_n_e_t-_a_d_d_r_e_s_s, _s_u_b_n_e_t-_m_a_s_k, ffffoooorrrrwwwwbbbb=_b_o_o_l_e_a_n}
  184.  
  185.                          This specifies the nnnneeeettttwwwwoooorrrrkkkk address and ssssuuuubbbbnnnneeeetttt mask
  186.                          for a stream below IP, and whether bbbbrrrrooooaaaaddddccccaaaassssttttssss are to
  187.                          be _f_o_r_w_a_r_d_e_d from other networks to that network.
  188.  
  189.                          This is typically used when a network is multiplexed
  190.                          below an IIIIPPPP (Internet Protocol) driver.  The Internet
  191.                          address and Subnet mask are given in standard
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. SSSSNNNNEEEETTTTDDDD((((1111MMMM))))                                                            SSSSNNNNEEEETTTTDDDD((((1111MMMM))))
  203.  
  204.  
  205.  
  206.                          Internet ddddooootttt format, and may be omitted (supplied as
  207.                          a null string) when not relevant, in which case they
  208.                          will be passed as zero.  The _b_r_o_a_d_c_a_s_t flag is
  209.                          specified as a boolean value:  yyyy or nnnn (for
  210.                          'yes'/'true' - 'do forward' - or 'no'/'false' -
  211.                          'don't forward'), or may be omitted in the default
  212.                          case (don't forward).
  213.  
  214.                          NNNNooootttteeee::::  A broadcast packet for transmission to a
  215.                          network either originates from the host or has
  216.                          previously been received from another network. The
  217.                          first type is always transmitted.  The second type is
  218.                          only transmitted if the forward broadcast flag ffffoooorrrrwwwwbbbb
  219.                          is set to 'y'. This flag is only relevant when using
  220.                          gateways.
  221.  
  222.                          In cases where only the network address is supplied,
  223.                          the following syntax may be used
  224.  
  225.                               IIIIPPPP____NNNNEEEETTTT=_i_n_t_e_r_n_e_t-_a_d_d_r_e_s_s
  226.  
  227.      AAAARRRRPPPP____TTTTYYYYPPPPEEEE=_t_r_a_i_l_e_r_s
  228.                          This specifies that this stream is to be rrrreeeeggggiiiisssstttteeeerrrreeeedddd
  229.                          with the network driver below as the stream on which
  230.                          incoming IIIIPPPP packets are to be received.
  231.  
  232.                          In addition, _t_r_a_i_l_e_r_s may take the value ttttrrrraaaaiiiilllleeeerrrrssss or
  233.                          nnnnoooottttrrrraaaaiiiilllleeeerrrrssss (the default), to specify whether trailer
  234.                          encapsulated packets should be sent on the network
  235.                          interface.
  236.  
  237.      LLLLLLLL____SSSSEEEETTTT____SSSSNNNNIIIIDDDD=_s_u_b_n_e_t-_i_d
  238.  
  239.                          This registers the _s_u_b_n_e_t_w_o_r_k _i_d_e_n_t_i_f_i_e_r (subnet-id)
  240.                          to be associated with this link.  The _s_u_b_n_e_t_w_o_r_k
  241.                          _i_d_e_n_t_i_f_i_e_r provides a unique name for an outlet to a
  242.                          board and its associated higher level streams.  It is
  243.                          a single alphanumeric character and is a mandatory
  244.                          parameter.
  245.  
  246.      XXXX22225555____SSSSEEEETTTT____SSSSNNNNIIIIDDDD={_s_u_b_n_e_t-_i_d, _c_l_a_s_s, _l_o_c_a_l-_S_A_P, _l_o_o_p-_S_A_P}
  247.  
  248.                          This registers the _s_u_b_n_e_t_w_o_r_k _i_d_e_n_t_i_f_i_e_r to be
  249.                          associated with this link, the _c_l_a_s_s of the network
  250.                          below the link, and the _l_o_c_a_l- and _l_o_o_p-_S_A_Ps to be
  251.                          associated with this subnetwork.
  252.  
  253.                          The class can be one of the following:
  254.  
  255.                          LC_LLC1        LLC-1,
  256.                          LC_LLC2        LLC-2,
  257.                          LC_LAPBDTE     LAPB - DTE,
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. SSSSNNNNEEEETTTTDDDD((((1111MMMM))))                                                            SSSSNNNNEEEETTTTDDDD((((1111MMMM))))
  269.  
  270.  
  271.  
  272.                          LC_LAPBXDTE    LAPB - DTE and extended addressing,
  273.                          LC_LAPBDCE     LAPB - DCE,
  274.                          LC_LAPBXCDE    LAPB - DCE and extended addressing.
  275.                          LC_LAPDTE      LAP - DTE,
  276.                          LC_LAPDCE      LAP - DCE,
  277.  
  278.                          The _S_A_Ps are only required for _c_l_a_s_s_e_s '_L_C__L_L_C_2' _a_n_d
  279.                          '_L_C__L_L_C_1'. They are two digit hexadecimal numbers.
  280.                          The _S_A_Ps must be even, non-zero and different.  If
  281.                          the _c_l_a_s_s is 'LC_LLC2', and the _S_A_Ps are not present,
  282.                          the defaults for local and loop _S_A_Ps are 0x7E and
  283.                          0x70 respectively.  If the _c_l_a_s_s is 'LC_LLC1', and
  284.                          the _S_A_P is not present, the default for local _S_A_P is
  285.                          0x7E.  For any other _c_l_a_s_s, the _S_A_Ps are not used.
  286.  
  287.                          The _s_u_b_n_e_t-_i_d and _c_l_a_s_s parameters are mandatory, but
  288.                          the _l_o_c_a_l-_S_A_P and _l_o_o_p-_S_A_P parameters are optional.
  289.  
  290.      SSSSHHHHEEEELLLLLLLL="_c_o_m_m_a_n_d-_s_t_r_i_n_g"
  291.  
  292.                          This allows calls to the shell.  Utilities may then
  293.                          be called at an intermediate stage in the building of
  294.                          the _S_T_R_E_A_M_S network.  For example:
  295.  
  296.                          ip      -      SHELL=" ixemap -Z; ixemap -P "
  297.  
  298.  
  299.                          This particular shell call to the _i_x_e_m_a_p(1M) utility
  300.                          deals with the IXE module internal table of X.25 and
  301.                          Internet address associations (as described in
  302.                          _i_x_e_m_a_p_c_o_n_f(4)).
  303.  
  304.                          A special dummy link exists, where no link is formed,
  305.                          but the control action is executed.  This occurs when
  306.                          token 2 is a hyphen (((( ''''----'''' )))) ....
  307.  
  308.                          For example:
  309.  
  310.                          x25     -       SHELL="pvcmap -P"
  311.  
  312.                          which is simply a shell call to execute ppppvvvvccccmmmmaaaapppp ....
  313.  
  314. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  315.      When the DLPI subsystem is installed, a sample configuration file is
  316.      installed at /etc/config/snetd.options, if the file does not already
  317.      exist.  The file contains sample configuration lines for three
  318.      interfaces: one token ring interface, one ethernet interface and one fddi
  319.      interface. As 'sample' configuration lines, the configuration lines are
  320.      commented out with an '#' sign at column one. To activate a particular
  321.      interface, the '#' signs must be removed.  The sample configuration file
  322.      installed by the product might contain the following network description
  323.      depending on your system configuration.  Please note that the line
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. SSSSNNNNEEEETTTTDDDD((((1111MMMM))))                                                            SSSSNNNNEEEETTTTDDDD((((1111MMMM))))
  335.  
  336.  
  337.  
  338.      numbers will not be in the shipped file but they are put in here for
  339.      reference purposes.
  340.  
  341.      /*line1*/ #fv0    d       /dev/fv0
  342.      /*line2*/ #ec0    d       /dev/ec0
  343.      /*line3*/ #ipg0   d       /dev/ipg0
  344.      /*line4*/ llc2    dc      /dev/llc2
  345.      /*line5*/
  346.      /*line6*/ %%
  347.      /*line7*/
  348.      /*line8*/ #llc2   fv0     LL_SET_SNID=A   \
  349.      /*line9*/ #      SHELL="lltune -P -p llc2 -s A -d /dev/llc2 def.tokenring"
  350.      /*line10*/#llc2   ec0     LL_SET_SNID=B   \
  351.      /*line11*/#      SHELL="lltune -P -p llc2 -s B -d /dev/llc2 def.ether"
  352.      /*line12*/#llc2   ipg0    LL_SET_SNID=C   \
  353.      /*line13*/#      SHELL="lltune -P -p llc2 -s C -d /dev/llc2 def.fddi"
  354.  
  355.  
  356.      To activate the token ring interface fv0, you need only take out the '#'
  357.      signs at the beginning of the line #1, #8, and #9. Line 9 is to execute
  358.      _l_l_t_u_n_e(1M) command to set default LLC2 tuning parameters for this token
  359.      ring interface.
  360.  
  361.      A typical configuration file for X.25 only, might contain the following
  362.      network description.
  363.  
  364.      echo    m       echo
  365.      ec0     dc      /dev/ec0
  366.      lapb    dc      /dev/lapb
  367.      llc2    dc      /dev/llc2
  368.      wan0    dc      /dev/wan0
  369.      x25     dc      /dev/x25
  370.  
  371.      %%
  372.  
  373.      llc2    ec0     LL_SET_SNID=C \
  374.                      SHELL="lltune -P -p llc2 -s C -d /dev/llc2 def.llc2"
  375.      x25     llc2    SHELL="x25tune -P -s C -d /dev/x25 -a 0000000000007E \
  376.                      def.lan.x25"   X25_SET_SNID={C, LC_LLC2, 7E, 70}
  377.  
  378.      lapb    wan0    LL_SET_SNID=A \
  379.                      SHELL="wantune -P -d /dev/wan0 -s A def.wan" \
  380.                      SHELL="lltune -P -p lapb -s A -d /dev/lapb def.lapb"
  381.      x25     lapb    SHELL="x25tune -P -s A -d /dev/x25 def.dte80.x25" \
  382.                      X25_SET_SNID={A, LC_LAPBDTE, , }
  383.  
  384.      lapb    wan0    LL_SET_SNID=B \
  385.                      SHELL="wantune -P -d /dev/wan0 -s B def.wan" \
  386.                      SHELL="lltune -P -p lapb -s B -d /dev/lapb def.lapb"
  387.      x25     lapb    SHELL="x25tune -P -s B -d /dev/x25 def.dte80.x25" \
  388.                      X25_SET_SNID={B, LC_LAPBDTE, , }
  389.  
  390.  
  391.  
  392.  
  393.                                                                         PPPPaaaaggggeeee 6666
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400. SSSSNNNNEEEETTTTDDDD((((1111MMMM))))                                                            SSSSNNNNEEEETTTTDDDD((((1111MMMM))))
  401.  
  402.  
  403.  
  404.      x25     -       SHELL="pvcmap -P"
  405.  
  406.      echo    ec0     ECHO_TYPE
  407.  
  408.  
  409.      Here, _w_a_n_0 and _e_c_0 are WAN and Ethernet drivers respectively, and your
  410.      real Ethernet driver may be eeeecccc0000 , eeeetttt0000 , or eeeennnnpppp0000 , depending on your
  411.      system configuration.  Note that the above is an example where lapb,
  412.      llc2, wan0 and ec0 are in-kernel.  _I_n_s_t_a_n_t_i_a_t_i_o_n_s are used.  Each
  413.      instantiation can be thought of as a separate block in a STREAMS
  414.      Architecture diagram.
  415.  
  416.      When TCP is to be run over X.25 a typical configuration file might
  417.      contain the following extra entries to cater for the IP to X.25
  418.      Encapsulation driver, IXE (see _i_x_e(7)).
  419.  
  420.      ixe     dc      /dev/ixe
  421.  
  422.      %%
  423.  
  424.      ip      ixe     IP_NET={15.0.0.2, 255.0.0.0, forwb=n}
  425.      ip      ixe     IP_NET={16.0.0.2, 255.0.0.0, forwb=n}
  426.      ixe     x25
  427.      ixe     x25
  428.      ixe     x25
  429.  
  430.      ip      -       SHELL="ixemap -Z" SHELL="ixemap -P" SHELL="ixetune"
  431.  
  432. FFFFIIIILLLLEEEESSSS
  433.      /_e_t_c/_c_o_n_f_i_g/_s_n_e_t_d
  434.      /_e_t_c/_c_o_n_f_i_g/_s_n_e_t_d._o_p_t_i_o_n_s
  435.  
  436. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  437.      dlpi(7), lltune(1M), ixemap(1M), pvcmap(1M), ixemapconf(4), ixe(7).
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.                                                                         PPPPaaaaggggeeee 7777
  460.  
  461.  
  462.  
  463.